home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 013 / xdir33.arc / XDIR33.DOC next >
Encoding:
Text File  |  1986-11-25  |  28.1 KB  |  684 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.               EXTENDED DISKETTE DIRECTORY PROGRAM
  12.  
  13.  
  14.                               XDIR
  15.  
  16.  
  17.  
  18.                           VERSION 3.3
  19.  
  20.  
  21.             
  22.  
  23.  
  24.                                       XDIR VERSION 3.3 PAGE -2-
  25.            
  26.                          INTRODUCTION
  27.  
  28.      Have you ever lost track of which diskette contained a
  29.      particular file? Do you spend a lot of time searching for
  30.      files and also for a diskette with enough room to store a
  31.      particular new program? If these problems are affecting you,
  32.      then this program should make your work much easier.
  33.  
  34.      XDIR will read the directory information directly from
  35.      your diskettes and keep these entries in a separate file
  36.      listed under an ID which you assign to your diskette.
  37.      Ideally this ID will be written on the label of the diskette
  38.      itself. In the future, as the contents of your diskettes
  39.      change you may delete or add their file contents to the
  40.      master file from XDIR.
  41.  
  42.      XDIR also allows you to enter a comment field for each
  43.      file to allow you to keep track of anything you wish about
  44.      each file. This information is entered through an editor
  45.      included as one of the menu options.
  46.  
  47.      You may wish to maintain separate files of certain
  48.      groups of your diskettes. For example, you may wish to have
  49.      separate files for your financial programs, your game
  50.      programs, and your word processing programs and files.
  51.  
  52.      XDIR allows you to select a subset of the master file
  53.      and either display it on the screen or print it out. This
  54.      would allow you to have a separate printout for your basic
  55.      programs, your OBJ files, and perhaps your EXE files. The
  56.      program allows great flexibility in this regard.
  57.  
  58.      It is also important to be able to find a diskette with
  59.      enough room to be able to store a new program you may have
  60.      written. XDIR calculates the amount of free space left on a
  61.      diskette and will give you a printout of all your diskettes
  62.      and the amount of space left on each.
  63.  
  64.                        Hardware Requirements
  65.  
  66.           At least 64KB of memory
  67.  
  68.           A 64KB machine will be able to run the CREATE
  69.      option but other options will only be able to handle 50
  70.      records. A 96KB machine will be able to read in 425 
  71.      records while a 128KB machine can handle 850.
  72.  
  73.           2 diskette drives
  74.  
  75.           80 column display (may be attached to either display
  76.      adapter) 
  77.  
  78.           The IBM 80cps printer (or equivalent) will enhance the
  79.      operation.
  80.  
  81.                                       XDIR VERSION 3.3 PAGE -3-
  82.           
  83.                     CHANGES FOR VERSION 3.3      
  84.  
  85.           1. I fixed the bug that caused the diskette inserts to
  86.      be done incorrectly if you selected the individual mode.
  87.      The bug caused ones that you selected to contain all the
  88.      records from those that were skipped.  No permanent damage
  89.      was done to your files, just the printout was incorrect.
  90.      This only affected diskette inserts and only if you selected
  91.      manually those that you wanted printed.
  92.  
  93.                                       XDIR VERSION 3.3 PAGE -4-
  94.  
  95.                     CHANGES FOR VERSION 3.2      
  96.  
  97.           1. Fixed the scrolling problem in display mode.
  98.  
  99.           2. The Logo for XDIR will appear first followed by a
  100.      prompt for the filename in the case where a filename was not
  101.      specified on the command line.
  102.  
  103.           3. The Create Option will issue a low tone when the
  104.      diskette in drive B may be changed.  This is a reinforcement
  105.      of the message that appears.
  106.  
  107.           4. The error tone is now shorter than before.
  108.  
  109.           5. I fixed the bug which sometimes caused the cursor to
  110.      change shape.
  111.  
  112.           6. Added a Miscellaneous options menu for displaying
  113.      the master files on the diskette and handling labels on the
  114.      B: drive.
  115.  
  116.           7. The Add/Replace option reads the diskette label and
  117.      if none, allows labeling.
  118.  
  119.           8. Individual diskette inserts may now be printed.  If
  120.      only a few diskettes have changed, you may now select which
  121.      ones you desire.
  122.  
  123.           9. The Print records option asks for a filename.  I now
  124.      check to make sure that you don't specify the name of the
  125.      space file or master file by mistake.
  126.  
  127.           10. I have added a better calculation of the maximum
  128.      number of records which can be handled.  This should take
  129.      care of any DOS extensions which may be resident.  This
  130.      number is now displayed on the menus.
  131.  
  132.           11. I have added a new option to the EDIT commands.  It
  133.      is ^D (Ctrl-D) which will duplicate the comment which
  134.      appears directly above it on the screen.  This is handy when
  135.      you have many files which are for the same program.
  136.  
  137.           12. I have changed the help on the EDIT screen to
  138.      indicate ^ when I am talking about the Ctrl Key.
  139.  
  140.           13. I have added a progress indicator for the
  141.      Replace/Add option to let you know what is going on.
  142.  
  143.                                       XDIR VERSION 3.3 PAGE -5-
  144.       
  145.                       CHANGES FOR VERSION 3.2      
  146.  
  147.           14. I have changed the definition of Home and End in
  148.      the EDIT screen.  Home will now move the cursor back to the
  149.      beginning of the comment field and End will move it 1
  150.      character past the end of the current comment field.  I now
  151.      have ^PgUp and ^PgDn do what these keys used to do.
  152.  
  153.           15. I have fixed the bug which caused the subset
  154.      searching of the Read option to function incorrectly.
  155.  
  156.           16. I rearranged some of the menus to improve
  157.      readability.
  158.  
  159.           17. If records are sorted by DISKID (as indicated by
  160.      the message at the bottom of the menus) and the Print
  161.      Records option is chosen from the display option menu, the
  162.      format of the printout is different.  This automatically
  163.      prints out blank lines at each DISKID change.  This will
  164.      make it easier for club librarians to publish lists of their
  165.      programs.
  166.  
  167.                                       XDIR VERSION 3.3 PAGE -6-
  168.        
  169.                     CHANGES FOR VERSION 3.1      
  170.  
  171.           1. You will notice that the EXE file is significantly
  172.      smaller than before. I have written my own file I/O routines
  173.      and removed the PASCAL library for file I/O. This makes the
  174.      program smaller and makes the program run faster.
  175.  
  176.           2. Sub menus now have options to go to the other
  177.      submenu.
  178.  
  179.           3. The problem with null filenames has been fixed.
  180.  
  181.           4. The CREATE menu has been changed to allow only
  182.      ENTER for signifying a new diskette has been inserted. Also
  183.      if your diskette has not been labeled, you will type the
  184.      DISKID right on this same panel. An option has also been
  185.      added for writing a label on your diskette. An audit trail
  186.      has also been added.
  187.  
  188.           5. I have attempted to catch most diskette writing
  189.      errors and not apend the program. This means that if your
  190.      diskette fills up, you will be informed and the program will
  191.      terminate that option.
  192.  
  193.           6. The editor has been changed to scroll the input area
  194.      for faster comment entry. The data is only scrolled if the
  195.      input area is at the top or bottom.
  196.  
  197.           7. I now convert all DISKIDs entered into capital
  198.      letters. I currently do not do that to old files. You may
  199.      have to use an editor on your old files to do this
  200.      conversion if you wish to do deletes on old files.
  201.  
  202.           8. The memory I check for is that which is installed in
  203.      your machine. I allocate space for the array according to
  204.      how much memory is installed. If you have DOS extensions, I
  205.      do not presently account for this extra space. If you are
  206.      using close to the maximum file size, be aware that your
  207.      program may end abruptly.
  208.  
  209.           9. I have removed most of the PASCAL library routines
  210.      to reduce the space required for the program. This has
  211.      resulted in missing some error conditions. I will hopefully
  212.      fix this in future releases.
  213.  
  214.           10. The maximum filesize for a 128K machine has been
  215.      raised to 850 records and for 96K to 425.
  216.  
  217.           11. I now use DOS function calls 11 and 12 to read the
  218.      directory information. This should help those of you who
  219.      have 80 track drives. Please check this out and let me know
  220.      if it works. Making this change resulted in a simpler
  221.      program with more potential function but it changed the
  222.      "rhythm" of the create and Add/Replace option.
  223.  
  224.           12. The program will now load in a 64KB machine but
  225.      only operate in a limited manner as explained above.
  226.  
  227.                                       XDIR VERSION 3.3 PAGE -7-
  228.      
  229.                      GENERAL INFORMATION      
  230.  
  231.           After loading the program you will see a menu. All
  232.      operations are performed by selecting options from this
  233.      menu. You only have to type the number of the option you
  234.      wish to invoke. In this program you will not have to press
  235.      the enter key for any single character responses. The
  236.      details of the menu operations will be covered in the next
  237.      section.
  238.  
  239.           The program uses 2 files to store the data you are
  240.      using. One of these files is the data file which contains
  241.      the list of directory entries read from your disks and the
  242.      other file is the space file which contains the amount of
  243.      space left on each of the disks which you entered. The
  244.      program will automatically check how much memory you have
  245.      installed and adapt itself accordingly.
  246.  
  247.           When you invoke the program you should specify the
  248.      filename you wish to use. This filename is the first part of
  249.      the name used by the program. For example, if you had
  250.      entered XDIR XYZ to invoke the program, then the 2 files the
  251.      program will be using will be XYZ.DAT and XYZ.SP. This
  252.      filename can be changed with one of the menu options.
  253.  
  254.           The program will detect if you are using double-sided
  255.      diskettes and read in the extended directory and calculate
  256.      the space remaining automatically.
  257.  
  258.           As another user-friendly feature the menus will
  259.      indicate how the data in storage has been sorted. It will
  260.      also tell how many records are currently in storage and the
  261.      name of the master file you are using.
  262.  
  263.  
  264.                                       XDIR VERSION 3.3 PAGE -8-
  265.       
  266.                     HOW TO USE THE PROGRAM      
  267.  
  268.  
  269.                        Getting Started
  270.  
  271.           Make sure your A drive is the default drive by entering
  272.      A: as a command to DOS. Then insert the program diskette
  273.      into the A drive and enter the command XDIR fname where
  274.      fname is the filename you wish to use as explained earlier.
  275.      If you forget to enter the fname parameter, the program will
  276.      prompt you for one. After the program is loaded, a logo will
  277.      be displayed with a reminder to remove the program diskette
  278.      and replace it with the data diskette. Press any key to
  279.      continue with the program.
  280.  
  281.  
  282.  
  283.                   How to Operate - Main Menu
  284.  
  285.           This section will cover the various options you will
  286.      see on the main menu.
  287.  
  288.           1 - Create file - This is the option you chose to
  289.      create the file on the disk. This will probably be the first
  290.      one you would choose the first time you run the program. It
  291.      will erase the file on disk if it exists and then allow you
  292.      to put the diskettes into your B: drive one at a time and
  293.      type in an ID for each one. You should be sure to write this
  294.      ID on the diskette label for future reference. The ID field
  295.      can be up to 8 characters of your choice as long as there are
  296.      no embedded blanks. Please note that this information is
  297.      written directly to disk, nothing is left in memory when you
  298.      have finished. To complete this option, just press the
  299.      Esc key. If you wish, you may put a file on your diskette
  300.      with the DISKID as the filename and LBL as the extension.
  301.      The Create option will look for this file and use the 
  302.      filename as the DISKID for this diskette. If it does not
  303.      find such a file, you will be prompted for the DISKID.
  304.      Further information on CREATE follows later in this
  305.      document.
  306.  
  307.                                       XDIR VERSION 3.3 PAGE -9-
  308.       
  309.                     HOW TO USE THE PROGRAM      
  310.             
  311.             How to Operate - Main Menu (continued)
  312.             
  313.  
  314.           2 - Read in file from Diskette - If you wish to process
  315.      the data file on the disk, you must use this option first.
  316.      Most other options work from the in-memory copy of the file
  317.      on disk. This option checks the amount of memory you have
  318.      installed and limits the size of what you can read in
  319.      accordingly. A message is displayed if the entire file
  320.      cannot be read in. After selecting this option, you will be
  321.      asked to specify the search argument for reading in data. If
  322.      you press the enter key you will select all files, otherwise
  323.      you may specify a subset - such as all your Basic programs.
  324.      Information on how to specify the subset will be given
  325.      later.
  326.  
  327.           3 - Write File to Disk - The contents of the memory
  328.      array is written back to the master file on the disk erasing
  329.      the previous contents. If you had wanted to preserve the old
  330.      contents of the file, you could use the option to change the
  331.      master file name and then use this option. This would create
  332.      a new file and write out the array to it. You must first be
  333.      sure that there is enough room on the diskette to store the
  334.      new data. You will be warned if a subset of files had been
  335.      read in and you try to write them out. This requires a
  336.      second response to perform the write.
  337.  
  338.           4 - Change Master File Name - This will change the
  339.      current filename being used by the program. Any future
  340.      reading or writing of files will be done with this filename.
  341.  
  342.           5 - Delete DISKID from file - this option will read in
  343.      the file into memory and remove those DISKIDs which match
  344.      the DISKIDs you specify as those to be deleted. If files are
  345.      currently residing in memory, you will be warned and given
  346.      an opportunity to cancel.
  347.  
  348.  
  349.                                       XDIR VERSION 3.3 PAGE -10-
  350.       
  351.                     HOW TO USE THE PROGRAM
  352.  
  353.             How to Operate - Main Menu (continued)
  354.  
  355.           6 - Edit Comment Fields - As mentioned earlier there is
  356.      a 28 character user specifiable comment field contained in
  357.      the file. This field is entered and edited with this option.
  358.      It is maintained by the other options and become part of
  359.      your file. It can be displayed either on your screen or the
  360.      printer. More details for the editor will be given later in
  361.      this document.
  362.  
  363.           7 - Replace/Add diskette - this works similarly to the
  364.      Delete diskette option in that it reads the file into
  365.      memory. However, after reading it in it asks you to put your
  366.      replacement diskette in the B drive and press Enter. The
  367.      directory information is read from the diskette. All files
  368.      which were on the old version of this diskette and the new
  369.      version will have the size and date updated thus saving the
  370.      comments. Any file on the old version and not on the new
  371.      version will be discarded. Any file on the new but not on
  372.      the old will be written out to the file.
  373.  
  374.           8 - Sort Options - Typing this number will cause a new
  375.      menu to appear. This new menu will be described later on in
  376.      this write-up.
  377.  
  378.           9 - Display Options - this option will also cause
  379.      another menu to appear giving all the options for
  380.      displaying/printing.
  381.  
  382.           A - Miscellaneous Options - this option will select the
  383.      menu which allows master files to be checked on the default
  384.      drive and check/change labels on the diskettes in the B:
  385.      drive.
  386.  
  387.           Esc - Pressing this key will cause the program to
  388.      terminate. If any editing was done without saving, the
  389.      program will warn you and give you an opportunity to cancel
  390.      termination.
  391.  
  392.                                       XDIR VERSION 3.3 PAGE -11-
  393.       
  394.                     HOW TO USE THE PROGRAM      
  395.  
  396.                   How to Operate - Sort Menu
  397.  
  398.             
  399.           When you select the Sort options from the main menu,
  400.      another menu will be displayed offering you the following
  401.      options:
  402.  
  403.           1 - Sort by Filename,Size,Date,ID - This option sorts
  404.      the in memory file in the indicated order. A message is
  405.      displayed to indicate that a sort is being done. With 700
  406.      records to sort,it can take 10-15 seconds, so please be
  407.      patient.
  408.  
  409.           2 - Sort by DISKID then Filename - Same as option 1 but
  410.      sorted as indicated. This sort is quicker due to fewer
  411.      fieldsbeing checked. It can take up to 10 seconds to sort
  412.      700 records.
  413.  
  414.           3 - Sort by Last Date Modified - same as above except
  415.      for the different sort field.
  416.  
  417.           4 - Sort on Comment Field - sometimes it may be useful
  418.      to have the data sorted by comment field. You may wish to
  419.      use some special coding for the first few characters of the
  420.      comments so that this sort will be more useful to you.
  421.  
  422.           5 - Sort Diskette Space Summary - This sort will put
  423.      the space summary records in order by DISKID. This is
  424.      extremely quick and therefore no sorting message is put on
  425.      the screen.
  426.  
  427.           9 - Display options - This option will take you to the
  428.      Display options sub-menu.
  429.  
  430.           A - Miscellaneous Options - This goes directly to the
  431.      Miscellaneous options menu.
  432.  
  433.           Esc - Pressing this key will return you to the main
  434.      menu.
  435.  
  436.  
  437.  
  438.                                       XDIR VERSION 3.3 PAGE -12-
  439.       
  440.                     HOW TO USE THE PROGRAM
  441.  
  442.             
  443.  
  444.                 How to Operate - Display Menu
  445.             
  446.  
  447.           When the Display option is selected on the main menu,
  448.      another menu will be displayed offering many choices as
  449.      described below:
  450.  
  451.           1 - Display Records - The contents of the array are
  452.      displayed on the screen. The PgUp and PgDn keys will be used
  453.      to scroll through the data shown on the screen. The Esc key
  454.      will be used to return to the menu.
  455.  
  456.           2 - Print Records - This option displays the same
  457.      information as option 1 but the information may either be
  458.      printed on the IBM 80cps printer or put into a file. The
  459.      option will prompt you for the filename to be used for the
  460.      printout. The default is preset to lpt1: but may be changed
  461.      to any file desired. This may be useful if you are using a
  462.      different file number for you printer or wish to store this
  463.      output in a file for use by some other program. Printer
  464.      control characters are only included if you leave the file
  465.      as lpt1: or lpt2: or lpt3:. 
  466.  
  467.           3 - Display Diskette Space Summary - The information
  468.      for the amount of space left on the disks contained in the
  469.      master file is displayed on the screen. The same options
  470.      exist here as exist for option 1.
  471.  
  472.           4 - Print Diskette Space Summary - Same as above but
  473.      the information is the space summary for the diskettes.
  474.  
  475.           5 - Print Diskette Inserts - You may select this option
  476.      to print inserts for your diskette envelopes. These will be
  477.      of the correct size to just fit in the envelope with the
  478.      part sticking out having the diskette id printed in double
  479.      width style. Also included on this insert is the amount of
  480.      space remaining on the diskette and all the files listed in
  481.      alphabetical order listed 5 across in condensed type. If you
  482.      have not sorted the memory array by DISKID, this option will
  483.      do it for you.  You will be asked if you wish to be prompted
  484.      for individual inserts or if you wish all printed.
  485.  
  486.           8 - Sort options - Selecting this option will take you
  487.      to the Sort options sub-menu.
  488.  
  489.           A - Miscellaneous Options - this will take you directly
  490.      to the miscellaneous options menu.
  491.  
  492.           Esc - Pressing this key will return you to the main
  493.      menu.
  494.  
  495.                                       XDIR VERSION 3.3 PAGE -13-
  496.       
  497.                     HOW TO USE THE PROGRAM
  498.  
  499.          How to Operate - Miscellaneous Options Menu
  500.  
  501.           1 - Display Master Files on Default Diskette - this
  502.      option will access the default diskette drive and display
  503.      the filenames of those files whose extension is DAT.
  504.  
  505.           2 - Delete Label on Drive B: - The B: drive is checked
  506.      for a label and if one is present, you may delete it.
  507.  
  508.           3 - Check Label on B: drive - This option will check
  509.      for a label and if present allow you to relabel the
  510.      diskette.
  511.  
  512.  
  513.                                       XDIR VERSION 3.3 PAGE -14-
  514.       
  515.                     HOW TO USE THE PROGRAM
  516.  
  517.             
  518.  
  519.                  How to Operate - Create Menu
  520.  
  521.             
  522.  
  523.  
  524.           This menu displays an audit trail of the last DISKIDs
  525.      that were processed. The most recent one is shown in high
  526.      intensity. It is a circular list. All data entry is done on
  527.      this menu. The status of automatic labeling is shown.
  528.  
  529.           There are 3 options on this menu.
  530.  
  531.           F1 - will redraw the screen. This is useful if you are
  532.      using automatic DISKID labeling and you mistakenly left the
  533.      write-protect tab on. This is explained below. This option
  534.      will clear the screen of any error messages. It will also
  535.      remove the audit trail of DISKIDs already processed.
  536.  
  537.           F2 - This toggles the automatic diskette labeling mode.
  538.      If this mode is on and your current diskette has no label,
  539.      one will be written to your diskette. This is a zero
  540.      length file with a file extension of LBL. Since a directory
  541.      entry is written to your diskette, the write-protect tab
  542.      should be removed if you turn the option on. If you forget,
  543.      DOS will present you with the usual error message to
  544.      Abort,Retry , or Ignore the error. I would not suggest
  545.      Aborting as your program will terminate. If you chose
  546.      Ignore, the program will continue without writing the label.
  547.      If you remove the tab and reinsert the diskette, you may
  548.      choose the Retry option. These error messages will remain on
  549.      the screen. If you wish to clear up the screen use the
  550.      F1 key. This will redraw the screen, but remove the audit
  551.      trail.
  552.            
  553.  
  554.           Esc - will return you to the master menu.
  555.  
  556.  
  557.                                       XDIR VERSION 3.3 PAGE -15-
  558.       
  559.                       REFERENCE MATERIAL
  560.  
  561.            Specifying Subset When Reading from File
  562.  
  563.             
  564.           When you enter option 2 you will be prompted to enter
  565.      the search parameter for which data you wish read in from
  566.      the file. If you press the enter key without typing
  567.      anything, the entire file is selected for processing. If you
  568.      enter any parameter, only a subset of the file will be read
  569.      in. This subset may be selected in a manner similar to the
  570.      syntax for the DOS DIR command. For example:
  571.  
  572.           If you enter *.BAS as the argument you will get only
  573.      those files which have an extension of BAS. If you had
  574.      entered ABC*.* you will get a subset consisting of all files
  575.      beginning with ABC and with any extension. You may also make
  576.      use of the ? wildcard allowed by DOS DIR. If you want all
  577.      files selected which have an extension of XYZ and have a
  578.      4 character filename beginning with Q you would enter
  579.      Q???.XYZ as the argument.
  580.  
  581.  
  582.  
  583.  
  584.                                       XDIR VERSION 3.3 PAGE -16-
  585.       
  586.                       REFERENCE MATERIAL
  587.  
  588.                 Explanation of Editor Commands
  589.  
  590.           The editor screen has been designed to give you a
  591.      partial look at how the particular entry you are editing
  592.      fits in with the others in the file. You will see 17 files
  593.      on the screen with the input area indicated in reverse
  594.      video. This input area is scrolled up and down on the
  595.      screen. The data will be scrolled if the input area is at
  596.      the top or bottom of the screen.
  597.  
  598.           In the upper right corner is an indicator which tells
  599.      you which record, by number, you are editing and how many
  600.      total there are in the file.
  601.  
  602.           At the bottom of the screen is a list of all the
  603.      commands and keys which are valid for the editor. These
  604.      commands are explained below:
  605.  
  606.  
  607.           (up arrow) - Pressing this key will move the editing
  608.      field one row toward the top of the screen. If you try to
  609.      scroll past the top of the file you will hear a beep.
  610.  
  611.           (down arrow) - Same as above but the active entry will
  612.      be the next lower one in the file.
  613.  
  614.           (right arrow) - the cursor is moved one position right
  615.      on the comment field. If the cursor reaches the end of the
  616.      comment field, it will automatically recycle back to the
  617.      beginning of the field.
  618.  
  619.           (left arrow) - same as above but the cursor moves to
  620.      the left. If the cursor moves to the left out of the comment
  621.      field it cycles back to the end of the comment field.
  622.  
  623.           (TAB Key) - Pressing this key moves to the next tab
  624.      stop which is every 10 spaces in the comment field.
  625.  
  626.           (S-TAB) - this function is accomplished by pressing the
  627.      Shift key and holding it while you press the Tab key. This
  628.      moves the cursor back to the previous tab stop.
  629.  
  630.                                       XDIR VERSION 3.3 PAGE -17-
  631.       
  632.                       REFERENCE MATERIAL
  633.  
  634.                 Explanation of Editor Commands
  635.  
  636.  
  637.           PgUp - When you select this command, the input area
  638.      will be scrolled toward the top of the file by 9 records.
  639.  
  640.           PgDn - Similar to the above function but the display
  641.      will be scrolled toward the bottom by 9 records.
  642.  
  643.           ENTER - pressing the ENTER key will perform the same
  644.      function as the down arrow - moving the input area 1 record
  645.      down toward the end of the file.
  646.  
  647.           ^C - Hold the Ctrl key while pressing the C key. This
  648.      will bring back the old comment from the file in memory.
  649.      This will only work if you have not yet pressed any of the
  650.      keys which move the input area on the display.
  651.  
  652.           Esc - pressing this key will return you to the main
  653.      menu. Any data entered in the editor is retained in the
  654.      in-storage array.
  655.  
  656.           ^PgUp - This moves the input area to the top of the
  657.      file.
  658.  
  659.           ^PgDn - The input area is moved to the end of the file.
  660.  
  661.           BKSPC - This is the key to the left of the Num Lock key
  662.      and is labeled with a left pointing arrow. This works by
  663.      deleting the character to the left of the cursor and
  664.      shifting everything to the left 1.
  665.  
  666.           Del - The character at the cursor position is deleted.
  667.  
  668.           Ins - Pressing the Insert key will put the editor in
  669.      insert mode. The Ins at the bottom of the screen will blink
  670.      indicating that Insert mode is active. Characters will be
  671.      inserted at the cursor location and other characters will be
  672.      shifted to the right. If there is no more room for
  673.      inserting, the speaker will beep.
  674.  
  675.           ^S - Hold the Ctrl key and press the S key and the
  676.      in-storage file will be written back to diskette.
  677.  
  678.           Home - This key will move the cursor back to the
  679.      beginning of the comment field.
  680.  
  681.           End - This key will position the cursor one character
  682.      past the end of the current length of the comment field.
  683.  
  684. eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee